Inside Macintosh: QuickDraw GX Printing /

Chapter 4 - Advanced Printing Features / Advanced Printing Features Reference

Functions / Color Profile Functions

GXSetPrinterProfile

You can call the GXSetPrinterProfile function to change the current color profile for a printer.

OSErr GXSetPrinterProfile (gxPrinter thePrinter,
            gxColorProfile oldProfile, gxColorProfile newProfile);

thePrinter

A reference to the printer object.

oldProfile

A reference to the profile that has been associated with the printer object.

newProfile

A reference to the profile to add to the list of profiles for a printer object.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

You can call GXSetPrinterProfile to change the current profile for a printer, to replace an existing profile that is associated with the printer object, or to remove a profile from the list of color profiles that are associated with the printer object.

A printer driver or printing extension defines the values of the oldProfile and newProfile parameters that determine what happens in response to this message. Table 4-6 shows an example.

The actions of the GXSetPrinterProfile function

Value of oldProfile	Value of newProfile	Action taken
nil	nil	None
Valid	nil	oldProfile is deleted from the list of profiles associated with the printer object.
nil	Valid	newProfile is added to the list of profiles for the printer object and becomes the current profile.
Valid	Valid	oldProfile is deleted from the list of profiles, newProfile is added, and newProfile becomes the current profile for the printer object.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

The gxSetPrinterProfile message is described in Inside Macintosh: QuickDraw GX Printing Extensions and Drivers.

Color matching, color profiles, and color profile resources are described in Inside Macintosh: Advanced Color Imaging.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help